home *** CD-ROM | disk | FTP | other *** search
/ Aminet 24 / Aminet 24 (1998)(GTI - Schatztruhe)[!][Apr 1998].iso / Aminet / util / cli / BinHex.readme < prev    next >
Encoding:
Text File  |  1998-02-07  |  5.2 KB  |  112 lines
  1. Short:    V1.18 edit HEX data in your ASCII editor
  2. Author:   stoecker@rcs.urz.tu-dresden.de (Dirk Stoecker)
  3. Uploader: stoecker@rcs.urz.tu-dresden.de (Dirk Stoecker)
  4. Version:  1.18
  5. Type:     util/cli
  6. Kurz:     Editieren von HEX-Daten mit ASCII Editor
  7.  
  8. This program has nothing to do with binhex transfer protocol.
  9.  
  10. This program converts data (for example program code) into the hexadecimal
  11. data system. This data could be edited with your favorite ASCII text
  12. editor. After that you can convert the data back to their old style. So you
  13. do not need a special hexadecimal editor and you will also be able to
  14. delete, insert parts of the file and things like that. Most hexadecimal
  15. editors only allow to change given data byte for byte.
  16.  
  17. Be sure you know what you are doing! To insert some data into program code
  18. most time crashes the program, because the internal addresses are now
  19. illegal. But the ability to delete data is useful for removing start code
  20. from modules, pictures or text.
  21.  
  22. BinHex needs OS 37 (2.0) or later OS versions!
  23.  
  24. USAGE:
  25.   BinHex BIN/A,HEX/A,MAKEBIN/S,ONLYDATA/S,ROWS/N,ASMDATA/S,CDATA/S,
  26.        REV=REVERSED/S,SIZE/N
  27.   BIN      give filename for original data file
  28.   HEX      give filename for hexadecimal data
  29.   MAKEBIN  set program to convert HEX to BIN (else BIN to HEX)
  30.   ONLYDATA add no ASCII output and no position info to hex data file
  31.   ROWS       give number of rows in one line (1 row = 4 byte)
  32.   ASMDATA  creates a field of ASM DC.x lines (not convertable back to bin).
  33.   CDATA    creates a C style array of data (not convertable back to bin).
  34.   REVERSED converts HEX format, where groups of bytes are in reverse
  35.          order (at the moment only in HEX->BIN mode)
  36.   SIZE     1) for ASMDATA and CDATA (1 = Byte, 2 = Word, 4 = Longword)
  37.          2) for REVERSED : gives size of REVERSED data (default = 16)
  38.   NOTAB    Some editors automatically expand tab stops into spaces (for
  39.        example standard editor C:ED). Use this option for these
  40.        editors together with MAKEBIN. Now BinHex accepts $ as line end
  41.        instead of \t (tab stop) as well.
  42.  
  43. The options ASMDATA and CDATA create an output useable in an assembler or
  44. C compiler. If you choose SIZE 2 or 4 and the file does not end at WORD or
  45. LONG boundaries, at the end zeros are added till the boundary.
  46.  
  47. To make it impossible to overwrite binary data if not wanted use every time
  48. one of the BIN or HEX keywords, but they are not needed!. «BinHex A B» is
  49. same as «BinHex A HEX B», but the second is saver.
  50.  
  51. hexadecimal data format:
  52.   In the hexadecimal file the data is interpreted from begin of line to next
  53.   tab stop (\t, $09). If there is no tab stop in the line it is done from
  54.   begin of line to next return (\n, $0A). All other parts and spaces are
  55.   ignored! With NOTAB option a line may end with $ (the start character of
  56.   address) as well.
  57.   If there is a \ in the data part all following characters to the next
  58.   tab stop (or return) are not converted. They are taken like given (good
  59.   for inserting readable text).
  60.  
  61. dir
  62.   example 1:
  63.   BIN data in RAM:A       Hello World!
  64. call BinHEX RAM:A HEX RAM:B ONLYDATA
  65.   HEX data in RAM:B       48656C6C6F20576F726C6421
  66.  
  67.   example 2:
  68.   HEX data in RAM:B      4865 6C6c 6f20\World!
  69. call BinHEX RAM:A HEX RAM:B MAKEBIN
  70.   BIN data in RAM:A       Hello World!
  71.  
  72. Please report me bugs, comments, suggestions and problems. If possible
  73. write a little mail if you use the program sometimes. If there are some
  74. Enforcer hits or other problems report them as good as possible.
  75.  
  76. Do not forget BinHex including source is Public Domain! I hope some more
  77. programmers follow the PD/Freeware idea. Shareware is good, but why pay
  78. for example 20$ for a very little utility?
  79.   
  80. Use it as you want, but WITHOUT ANY WARRANTY!
  81.  
  82. Please contact me:
  83.  
  84. ****************************************************************************
  85. * snail-mail:                  * e-mail:                                   *
  86. *   Dirk Stoecker              *   stoecker@rcs.urz.tu-dresden.de          *
  87. *   Geschwister-Scholl-Str. 10 *   stoecker@amigaworld.com                 *
  88. *   01877 Bischofswerda        * world wide web:                           *
  89. *   GERMANY                    *   http://home.pages.de/~Gremlin/          *
  90. * phone:                       * pgp key:                                  *
  91. *   GERMANY +49 (0)3594/706666 *   get with finger or from WWW pages       *
  92. ****************************************************************************
  93.  
  94.  
  95. ============================= Archive contents =============================
  96.  
  97. Original  Packed Ratio    Date     Time    Name
  98. -------- ------- ----- --------- --------  -------------
  99.     6080    3298 45.7% 10-Jan-98 14:40:36  BinHex
  100.     4442    2031 54.2% 10-Jan-98 14:41:08  BinHex.readme
  101.    10750    3822 64.4% 10-Jan-98 14:41:10 +BinHex.c
  102.      440     252 42.7% 10-Jan-98 14:41:42 +SDI_ASM_functions.lib
  103.     1251     576 53.9% 10-Jan-98 14:42:00 +SDI_ASM_protos.h
  104.     2048     788 61.5% 10-Jan-98 14:41:42 +SDI_ASM_STD_functions.lib
  105.     5282    1838 65.2% 10-Jan-98 14:42:02 +SDI_ASM_STD_protos.h
  106.     3232    1399 56.7% 10-Jan-98 14:42:02 +SDI_defines.h
  107.     2448    1076 56.0% 10-Jan-98 14:41:42 +SDI_functions.o
  108.     2537    1033 59.2% 10-Jan-98 14:42:02 +SDI_protos.h
  109.      618     359 41.9% 10-Jan-98 14:42:02 +SDI_structures.h
  110. -------- ------- ----- --------- --------
  111.    39128   16472 57.9% 26-Jan-98 21:39:58   11 files
  112.